Konfigurieren eingehender E-Mails unter Verwendung von OAuth2 unter Office 365
Sie können Microsoft Office 365 für eingehende E-Mails nutzen, indem Sie Microsoft Graph OAuth2 verwenden. Erstellen Sie dazu eine App-Registrierung für Microsoft Graph in Office 365, schränken Sie den Postfachzugriff ein und konfigurieren Sie anschließend das Service Desk-Postfach.
Einzelheiten zum Konfigurieren eines Postfachs unter Verwendung von IMAP4 finden Sie unter Konfigurieren eines Postfachs für die einzelnen Zuordnungen.
Der erste Schritt ist die Erstellung einer App-Registrierung für "Ivanti Service Desk, Eingang" in Azure.
So erstellen Sie eine App-Registrierung:
- Melden Sie sich als Administrator bei https://portal.office.com an und öffnen Sie die Administratorverknüpfung.
- Öffnen Sie im Microsoft 365 Admin Center das mit Ihrem Office 365-Mandanten verknüpfte Azure Active Directory-Konto.
- Registrieren Sie eine neue Einzelmandantanwendung.
Anschließend müssen einige API-Berechtigungen geändert werden. - Entfernen Sie die Leseberechtigung für den delegierten Benutzer.
- WICHTIG: Fügen Sie als Anwendungsberechtigung (für Microsoft Graph) "Mail ReadWrite" hinzu und erteilen Sie die Admin-Zustimmung.
Dadurch besitzt die Anwendung, wenn sie über Administratorzustimmung verfügt, die Berechtigung zum Verwenden der Microsoft Graph-API zum Lesen und Schreiben von E-Mails in allen Postfächern Ihres Office 365-Mandanten. Im nächsten Schritt wird diese Berechtigung eingeschränkt.
Nachdem Sie die App "Ivanti Service Desk, Eingang" registriert haben, müssen Sie den Postfachzugriff einschränken, damit die Azure-App nur auf ein Postfach zugreifen kann.
Weitere Informationen finden Sie im Abschnitt zum Begrenzen der Anwendungsberechtigungen auf bestimmte Exchange Online-Postfächer auf der Dokumentationswebsite von Microsoft (wird in neuem Register geöffnet).
So schränken Sie den Postfachzugriff ein:
- Melden Sie sich als Administrator bei https://portal.office.com an.
- Erstellen Sie eine neue mailfähige Sicherheitsgruppe.
- Fügen Sie der Gruppe ein Mitglied hinzu.
Dies ist der eine Benutzer, der dem Postfach "Eingang" im Service Desk entspricht.
Der nächste Schritt besteht darin, diese Gruppe mit der App-Registrierung in Azure zu verknüpfen. Verbinden Sie sich dazu über PowerShell mit Exchange Online und geben Sie den Befehl "New-ApplicationAccessPolicy" aus. - Installieren Sie das Exchange Online PowerShell-Modul.
Weitere Informationen finden Sie unter Verbinden mit Exchange Online PowerShell auf der Dokumentationswebsite von Microsoft (wird in einem neuen Register geöffnet). - Stellen Sie unter Verwendung von MFA eine Verbindung zu Exchange Online PowerShell her.
- Konfigurieren Sie ApplicationAccessPolicy, um Ihre Gruppe mit der Azure-App zu verknüpfen.
Wenn Sie den PowerShell-Befehl New-ApplicationAccessPolicy verwenden, der im Abschnitt zum Begrenzen der Anwendungsberechtigungen auf bestimmte Exchange Online-Postfächer auf der Dokumentationswebsite von Microsoft (wird in neuem Register geöffnet) beschrieben wird, entspricht der Parameter "AppId" Ihrer Azure-Anwendungs-ID (auch bekannt als Client-ID). Der Parameter "PolicyScopeGroupId" ist die Gruppen-E-Mail-Adresse der von Ihnen erstellten mailfähigen Sicherheitsgruppe. - Testen Sie die Konfiguration mit Benutzern, auf die die Anwendung zugreifen können sollte bzw. nicht zugreifen können sollte.
Bei Verwendung des oben genannten Dokuments von Microsoft können Sie dazu den Befehl Test-ApplicationAccessPolicy ausgeben. - Melden Sie sich ab.
Warten Sie etwa 30 Minuten, bis die Konfiguration abgeschlossen ist. Bis dahin haben API-Aufrufe an Microsoft Graph, die Ihre App verwenden, Zugriff auf die Postfächer aller Benutzer.
Nachdem Sie eine App-Registrierung für Microsoft Graph in Office 365 erstellt und den Postfachzugriff eingeschränkt haben, können Sie das Service Desk-Postfach für die Verwendung von Office 365 für eingehende E-Mails konfigurieren.
So konfigurieren Sie das Service Desk-Postfach für die Verwendung von Office 365 für eingehende E-Mails:
- Stoppen Sie unter Verwendung des Configuration Centers den Dienst Mail Manager – Eingehender Service.
- Erweitern Sie in der Komponente Mail in der Struktur E-Mail-Einrichtung den Ordner Eingehende E-Mail und wählen Sie dann den Ordner Postfächer aus.
- Klicken Sie in der Liste Aktionen auf Neues Postfach.
Das Fenster "Postfach" wird angezeigt. - Wählen Sie in der Liste Anbieter die Option Microsoft Graph (OAuth2) aus.
Das Dialogfeld wird aktualisiert. - Geben Sie einen Titel ein und wählen Sie eine Zuordnung aus.
- Legen Sie unter Anmeldedetails als Benutzername den Benutzerprinzipalnamen für Ihr Office 365-Postfach fest.
Dieser hat das Format einer E-Mail-Adresse. - Erstellen Sie in der App-Registrierung in Azure einen Geheimschlüssel über die Verknüpfung Zertifikate & Geheimschlüssel und verwenden Sie diesen für das Feld Geheimschlüssel unter OAuth2-Details bei den Einstellungen in Service Desk.
- Verwenden Sie als Client-ID und Mandanten-ID unter OAuth2-Details bei den Postfacheinstellungen die Anwendungs-ID (Client) und die Verzeichnis-ID (Mandant) aus der Verknüpfung "Übersicht" Ihrer App-Registrierung in Azure.
- Klicken Sie in der Symbolleiste auf , um sicherzustellen, dass die Authentifizierung erfolgreich war und Zugriff auf das Office 365-Postfach besteht.
- Speichern Sie das neue Postfach.
- Starten Sie Mail Manager – Eingehender Service.
Um zu prüfen, ob der Zugriff auf das Postfach korrekt eingeschränkt wurde, stoppen Sie den eingehenden Service, ändern Sie den Benutzernamen bei den Postfacheinstellungen in Service Desk in den eines Benutzers ab, der nicht zu Ihrer Sicherheitsgruppe gehört, und klicken Sie auf .
Die Authentifizierung müsste erfolgreich verlaufen, jedoch sollte der Zugriff auf das Postfach fehlschlagen.
Denken Sie daran, den Namen des Benutzers wieder auf einen Benutzer zu ändern, der Mitglied der Mail-Sicherheitsgruppe ist, und starten Sie dann den eingehenden Service wieder.